<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 3//EN">
<HTML><HEAD>
<TITLE>IBM Visualization Data Explorer Programmer&#39;s Reference</TITLE>

<META HTTP-EQUIV="abstract" CONTENT="IBM Visualization Data Explorer
Programmer&#39;s Reference">
<META HTTP-EQUIV="contact" CONTENT="IBM Visualization Data Explorer
(ibmdx@watson.ibm.com)">
<META HTTP-EQUIV="owner" CONTENT="IBM Visualization Data Explorer
(ibmdx@watson.ibm.com)">
<META HTTP-EQUIV="updated" CONTENT="Tue, 16 Sep 1997 ">
<META HTTP-EQUIV="review" CONTENT="Fri, 14 Aug 1998 ">

<META HTTP-EQUIV="keywords" CONTENT="GRAPHICS VISUALIZATION VISUAL PROGRAM DATA
MINING">
<meta http-equiv="content-type" content="text/html;charset=ISO-8859-1">
</HEAD><BODY BGCOLOR="#FFFFFF">

<A NAME="Top_Of_Page"></A>
<H1>IBM Visualization Data Explorer Programmer&#39;s Reference</H1>
<B>&#91; <A HREF="#Bot_Of_Page">Bottom of Page</A> &#124; <A
HREF="progu257.htm">Previous Page</A> &#124; <A HREF="progu259.htm">Next
Page</A> &#124; <A HREF="../proguide.htm#ToC">Table of Contents</A> &#124; <A
HREF="progu097.htm#PToC20">Partial Table of Contents</A> &#124; <A
HREF="progu344.htm#HDRINDEX_START">Index</A> &#93;</B><HR><P>
<H3><A NAME="HDRDXNPAV" HREF="progu097.htm#PToC_352">DXNewProductArray,
DXNewProductArrayV</A></H3>
<A NAME="IDX1929"></A>
<A NAME="IDX1930"></A>
<A NAME="IDX1931"></A>
<A NAME="IDX1932"></A>
<P><STRONG>Function</STRONG>
<P>
Create an Array that is the product of a set of regular or irregular
position Arrays.
<P><STRONG>Syntax</STRONG>
<BR>
<TT><STRONG><BR>
&#35;include &lt;dx/dx.h&gt;<BR>
<P><BR>
ProductArray DXNewProductArray(int n, ...)<BR>
ProductArray DXNewProductArrayV(int n, Array *terms)<BR>
</STRONG></TT><BR>
<P><STRONG>Functional Details</STRONG>
<P>
All of the Array types must be floating-point and of
the same rank and shape.
The Array created will have the same rank and shape as the input
Arrays.
The terms of the product are given by the
Array
pointer
<TT><STRONG>
terms
</STRONG></TT>
(for <TT><STRONG>DXNewProductArrayV</STRONG></TT>)
or by the last
<TT><STRONG>n</STRONG></TT>
arguments (for <TT><STRONG>DXNewProductArray</STRONG></TT>).
<P>
Product Arrays are most often used to construct regular or
partially regular
"positions"
components.
In the case of fully regular positions (e.g., when each of the items is
a Regular Array), it is often be easier to use
<TT><STRONG>DXMakeGridPositions</STRONG></TT>.
<P>
The Array created can be deleted with DXDelete.
See <A HREF="progu023.htm#HDRMEMNG">4.2 , "Memory Management"</A>.
<P><STRONG>Return Value</STRONG>
<P>
Return the Product Array or returns <TT><STRONG>NULL</STRONG></TT> and
set an error code.
<P><STRONG>See Also</STRONG>
<P>
<TT><STRONG>
<A HREF="progu193.htm#HDRDXGPAI">DXGetPathArrayInfo</A>,
<A HREF="progu233.htm#HDRDXMGPV">DXMakeGridPositions, DXMakeGridPositionsV</A>
</STRONG></TT>
<P>
<A HREF="progu046.htm#HDRPTAS">"Product Arrays"</A>.
<P><HR><B>&#91; <A HREF="#Top_Of_Page">Top of Page</A> &#124; <A
HREF="progu257.htm">Previous Page</A> &#124; <A HREF="progu259.htm">Next
Page</A> &#124; <A HREF="../proguide.htm#ToC">Table of Contents</A> &#124; <A
HREF="progu097.htm#PToC20">Partial Table of Contents</A> &#124; <A
HREF="progu344.htm#HDRINDEX_START">Index</A> &#93;</B> <br><b>&#91;<a
href="../allguide.htm">Data Explorer Documentation</a>&nbsp;&#124;&nbsp;<a
href="../qikguide.htm">QuickStart Guide</a>&nbsp;&#124;&nbsp;<a
href="../usrguide.htm">User&#39;s Guide</a>&nbsp;&#124;&nbsp;<a
href="../refguide.htm">User&#39;s Reference</a>&nbsp;&#124;&nbsp;<a
href="../proguide.htm">Programmer&#39;s Reference</a>&nbsp;&#124;&nbsp;<a
href="../insguide.htm">Installation and Configuration
Guide</a>&nbsp;&#93;</b><br><p><b>&#91;<a
href="http://www.research.ibm.com/dx">Data Explorer Home
Page</a>&#93;</b><p><HR ALIGN=LEFT WIDTH=600><b>&#91;<A
HREF="http://www.ibm.com/">IBM Home Page</A>&nbsp;&#124;&nbsp;<A
HREF="http://www.ibm.com/Orders/">Order</A>&nbsp;&#124;&nbsp;<A
HREF="http://www.ibm.com/Search/">Search</A>&nbsp;&#124;&nbsp;<A
HREF="http://www.ibm.com/Assist/">Contact IBM</A>&nbsp;&#124;&nbsp;<A
HREF="http://www.ibm.com/Legal/">Legal</A>&nbsp;&#93;</b><hr><p>
<A NAME="Bot_Of_Page"></A>
</BODY></HTML>
